home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1993 July / InfoMagic USENET CD-ROM July 1993.ISO / sources / x / volume0 / awm / part13 < prev    next >
Encoding:
Internet Message Format  |  1988-08-12  |  41.9 KB

  1. Path: uunet!wyse!mikew
  2. From: mikew@wyse.wyse.com (Mike Wexler)
  3. Newsgroups: comp.sources.x
  4. Subject: v00i014:  Ardent Window Manager(X11), Part13/13
  5. Message-ID: <1637@wyse.wyse.com>
  6. Date: 12 Aug 88 15:25:34 GMT
  7. Sender: news@wyse.wyse.com
  8. Lines: 1004
  9. Approved: mikew@wyse.com
  10.  
  11. Submitted-by: unido!pcsbsd!jkh (Jordan Hubbard)
  12. Posting-number: Volume 0, Issue 14
  13. Archive-name: awm/part13
  14.  
  15. #! /bin/sh
  16. # This is a shell archive.  Remove anything before this line, then unpack
  17. # it by saving it into a file and typing "sh file".  To overwrite existing
  18. # files, type "sh file -c".  You can also feed this as standard input via
  19. # unshar, or by typing "sh <file", e.g..  If this archive is complete, you
  20. # will see the following message at the end:
  21. #        "End of archive 13 (of 13)."
  22. # Contents:  awm/awm.man
  23. # Wrapped by mikew@wyse on Mon Aug  8 12:01:49 1988
  24. PATH=/bin:/usr/bin:/usr/ucb ; export PATH
  25. if test -f awm/awm.man -a "${1}" != "-c" ; then 
  26.   echo shar: Will not over-write existing file \"awm/awm.man\"
  27. else
  28. echo shar: Extracting \"awm/awm.man\" \(40183 characters\)
  29. sed "s/^X//" >awm/awm.man <<'END_OF_awm/awm.man'
  30. X.de EX          \" Begin example
  31. X.ne 5
  32. X.if n .sp 1
  33. X.if t .sp .5
  34. X.nf
  35. X.in +.5i
  36. X..
  37. X.de EE        \" End example
  38. X.fi
  39. X.in -.5i
  40. X.if n .sp 1
  41. X.if t .sp .5
  42. X..
  43. X.TH AWM 1 "26 July 1988" "X Version 11"
  44. X.SH NAME
  45. X.PP
  46. Xawm - Window Manager X Client Application
  47. X.PP
  48. X.SH SYNOPSIS
  49. X.PP
  50. X.B awm
  51. X[
  52. X.B \-f
  53. Xfilename
  54. X] [
  55. X.B \-e
  56. Xexecfile
  57. X] [
  58. X.B \-b
  59. X] [
  60. X.B \-i
  61. X]
  62. X.PP
  63. X.SH DESCRIPTION
  64. X.PP
  65. XThe \fIawm\fP command is a window manager client 
  66. Xapplication of the window 
  67. Xserver. It is heavily based on an earlier work by M. Gancarz
  68. Xof Digital Equipment Corporation (see the end of this document for
  69. Xappropriate acknowledgments).
  70. X.PP
  71. XWhen the command is invoked, it traces a predefined search path
  72. Xto locate any \fIawm\fP startup files.  If no startup files
  73. Xexist, \fIawm\fP initializes its built-in default file.
  74. X.PP
  75. XIf startup files exist in any of the following locations,
  76. Xit adds the variables to the default variables.  
  77. XIn the case of contention, the variables in the last file found
  78. Xoverride previous specifications.  Files in the \fIawm\fP
  79. Xsearch path are:
  80. X.EX
  81. X$LIBDIR\fI/awm/system.awmrc\fP
  82. X$HOME\fI/.awmrc\fP
  83. X.EE
  84. X.PP
  85. XTo use only the settings defined in a single startup file,
  86. Xinclude the variables, \fBresetbindings\fP, \fBresetmenus\fP and
  87. X\fBresetgagdets\fP at the top of that specific startup file.
  88. X.PP
  89. X.SH OPTIONS
  90. X.IP "\fB\-f\fP filename"
  91. XNames an alternate file as an \fIawm\fP startup file.
  92. X.IP "\fB\-e\fP execfile"
  93. XNames a file to exec (typically a shell script invoking other clients) after
  94. Xall startup files have been loaded. This is useful for minimizing the number of
  95. Xmap/unmaps that occur when titlebars are added.
  96. X.IP "\fB\-b\fP"
  97. XCauses \fIawm\fP to ignore the system startup file.
  98. X.IP "\fB\-i\fP"
  99. XCauses \fIawm\fP to ignore $HOME/\fI.awmrc\fP.
  100. X.PP
  101. X.SH STARTUP FILE VARIABLES
  102. X.PP
  103. XVariables are typically entered first, at the top of the startup
  104. Xfile. Because of a merge with the resource manager, very few variables
  105. Xare set here now. The directives \fBresetbindings\fP, \fBresetmenus\fP
  106. Xand \fBresetgadgets\fP are still allowed, as are gadget declarations of
  107. Xthe form:
  108. X.EX
  109. X\fBgadget[\fP\fIn\fB]\fP=\fIexpr\fP
  110. X.EE
  111. X.PP
  112. XWhere \fIn\fP is a positive integer indicating the gadget to initialize and
  113. X\fIexpr\fP is one of the following:
  114. X.IP "\fIstring\fP or ""\fIstring\fP"" [ ^ \fIattributes\fP ]"
  115. XSet the name of the gadget to \fIstring\fP. The name will be
  116. Xpainted in the gadget box with the \fBgadget.font\fP resource
  117. Xor an overriding font attribute (see below).
  118. X\fIstring\fP may contain embedded non-alphanumeric characters
  119. Xin the form of \\\fI#\fP where \fI#\fP is one or more decimal digits (i.e. \\54)
  120. Xor \\\fIc\fP where \fIc\fP is a character in the standard C string
  121. Xliteral set (i.e. n, r, t, f). This is useful if you've specified
  122. Xa gadget font with glyphs in it (such as cursor) and you want to paint
  123. Xa specific glyph from it in a gadget box. Many such glyphs are not
  124. Xrepresented by ascii characters.
  125. X.IP "(\fIstring\fP) [ ^ \fIattributes\fP ]"
  126. XLoad a pixmap from the file named by \fIstring\fP and
  127. Xtile the gadget with it (see also: \fBpath\fP).
  128. X.PP
  129. XAdditional \fIattributes\fP may be specified after a '^' (caret)
  130. Xcharacter in the form:
  131. X.IP "\fIoffset\fP|\fIgravity\fP|\fIforeground\fP|\fIbackground\fP|\fIfont\fP"
  132. XAny omitted parameters will be set to default values.
  133. X.IP
  134. X\fIoffset\fP is an integer specifying how far to place this
  135. Xgadget from its nearest neighbor (or an edge). Default
  136. Xoffset is \fBgadget.pad\fP, or 2 if \fBgadget.pad\fP is not
  137. Xdefined.
  138. X.IP
  139. X\fIgravity\fP is one of \fBNoGravity\fP, \fBLeftGravity\fP,
  140. X\fBRightGravity\fP or \fBCenterGravity\fP. \fBNoGravity\fP specifies that
  141. Xthe gadget is to be placed opposite of wherever the last gadget was
  142. Xplaced.
  143. X\fBLeftGravity\fP specifies that the gadget should stick to
  144. Xthe left of the title bar, \fBRightGravity\fP to the right and
  145. X\fBCenterGravity\fP to the center.
  146. X.IP
  147. X\fIforeground\fP and \fIbackground\fP specify the colors used to
  148. Xtile the gadget or draw the text.
  149. X.IP
  150. X\fIfont\fP is the name of the font you want the gadget's name
  151. Xdrawn in. This overrides the \fBgadget.font\fP setting for this
  152. Xgadget.
  153. X.IP
  154. XThe default values for \fIattributes\fP are 0, \fBNoGravity\fP, black
  155. X(\fBreverse\fP: white) and white (\fBreverse\fP: black), the setting
  156. Xof \fBgadget.font\fP.
  157. X.PP
  158. XIt is important to note that in the absence of a \fIgravity\fP specification
  159. X(i.e. we've defaulted to \fBNoGravity\fP), the window manager will
  160. Xautomatically place a gadget on the side opposite of the last gadget
  161. Xplaced. If it's the first gadget placed, it will go to the right.
  162. XThus in the absence of any \fIgravity\fP (or \fIoffset\fP) specifications,
  163. Xthe window manager will place gadgets in a right-left-right fashion
  164. Xuntil all gadgets have been placed.
  165. X.PP
  166. XFor example:
  167. X.EX
  168. Xgadget[0] = "die"
  169. Xgadget[1] = (resize.b) ^ 2 | red | orange
  170. Xgadget[2] = (iconbox.b) ^ | LeftGravity
  171. Xgadget[3] = "\\56" ^ | LeftGravity | green | black | cursor
  172. X.EE
  173. X.PP
  174. XThese declarations will create 4 gadget boxes, situated in the
  175. Xfollowing manner:
  176. X.PP
  177. XThe first gadget box will be created wide enough to print the
  178. Xword "die" in it (in whatever gadget font has been defined) and
  179. Xwill be placed on the right side (since it hasn't chosen a gravity)
  180. Xagainst the edge (since it hasn't chosen an offset).
  181. XBackground and foreground colors will be black and white
  182. X(assignment depending on whether \fBreverse\fP is set).
  183. X.PP
  184. XThe second gadget box will be tiled with the contents of the
  185. Xfile "resize.b" (assuming that it's a valid bitmap file) and
  186. Xwill go on the left side (since it also has no gravity and the
  187. Xlast one went on the right). It will be offset from the edge by 2
  188. Xpixels since there was an offset for it. Foreground will be
  189. Xred, background will be orange.
  190. X.PP
  191. XThe third gadget will be tiled with the contents of "iconbox.b"
  192. Xand will be placed against the second gadget on the left hand
  193. Xside since we specified a gravity. Colors will be black and white
  194. X(depending on \fBreverse\fP).
  195. X.PP
  196. XThe fourth gadget will display glyph #56 from the cursor font
  197. Xin green and black (it's gumby of course).
  198. X.PP
  199. XIMPORTANT: Gadgets may be declared in any order, but you are
  200. Xnot allowed to leave gaps, i.e..it's perfectly acceptable to
  201. Xdeclare gadgets in the order 0, 2, 3, 1, but \fBnot\fP legal to
  202. Xdeclare gadgets in the order 0, 3, 2, 4 as gadget #1 has been
  203. Xomitted. This restriction may be removed in the future, but
  204. Xfor now you'll get a diagnostic and \fIawm\fP will exit.
  205. X.PP
  206. XAll other variables controlling window manager behavior are described in
  207. Xthe \fBX DEFAULTS\fP section of this man page.
  208. X.PP
  209. X.SH BINDING SYNTAX
  210. X.PP
  211. XMouse buttons may be bound to particular window manager functions with:
  212. X.EX
  213. X"\fIfunction\fP=[\fImodifier key(s)\fP]:[\fIcontext\fP]:\fImouse events\fP:\fI" menu name "\fP
  214. X.EE
  215. Xor 
  216. X.EX
  217. X"\fIfunction\fP=[\fImodifier key(s)\fP]:[\fIcontext\fP]:\fImouse events\fP:\fI" text action "\fP
  218. X.EE
  219. X.PP
  220. XFunction and mouse events are the only required fields.  The menu name is
  221. Xrequired with the \fIf.menu\fP function definition only.
  222. XSimilarly, text action is required only with the \fIf.action\fP
  223. Xfunction definition.
  224. X.PP
  225. X.SH Function
  226. X.PP
  227. X.IP \fBf.action\fP
  228. XInvokes a text action. `text' should be in quotes with a preceding
  229. X"action" character (one of '^', '!' or '|'). The syntax is identical to
  230. Xmenu text actions which are discussed in greater detail under the \fBMenus\fP
  231. Xsection of this document.
  232. X.EX 0
  233. X.B
  234. Xf.action=[\fImodifier key(s)\fP]:[\fIcontext \fP]:\fImouse events\fP:\fIaction" text "\fP
  235. X.EE
  236. X.IP "\fBf.beep\fP" 15
  237. Xemits a beep from the keyboard.  Loudness is determined by 
  238. Xthe volume variable.
  239. X.IP \fBf.circledown\fP
  240. Xcauses the top window that is obscuring another 
  241. Xwindow to drop to the bottom of the stack of windows.  
  242. X.IP \fBf.circleup\fP
  243. Xexposes the lowest window that is obscured by other
  244. Xwindows. 
  245. X.IP \fBf.continue\fP
  246. Xreleases the window server display action after you 
  247. Xstop action with the \fBf.pause\fP function.  
  248. X.IP \fBf.destroy\fP
  249. Xcalls XKillClient on the selected window. Use with caution!! Binding it to
  250. Xnaked mouse buttons is probably not a good idea!
  251. X.IP \fBf.exit\fP
  252. Xexits the window manager. If you've started \fIawm\fP from
  253. X\fIxinit\fR (actually sort of useful now that the \fB\-e\fP flag
  254. Xhas been added), this will also exit the window system.
  255. X.IP \fBf.focus\fP
  256. Xdirects all keyboard input to the selected window.
  257. XTo reset the focus to all windows, invoke \fIf.focus\fP from the root
  258. Xwindow.
  259. X.IP \fBf.iconify\fP
  260. XWhen implemented from a window, this function converts the window 
  261. Xto its respective icon.  When implemented from an icon, 
  262. Xf.iconify converts the icon to its respective window.  
  263. X.IP \fBf.lower\fP
  264. Xlowers a window that is obstructing a window below it.
  265. X.IP \fBf.menu\fP
  266. Xinvokes a menu.  Enclose `menu name' in quotes if it
  267. Xcontains blank characters or parentheses.  
  268. X.EX 0
  269. X.B
  270. Xf.menu=[\fImodifier key(s)\fP]:[\fIcontext \fP]:\fImouse events\fP:\fI" menu name "\fP
  271. X.EE
  272. X.IP \fBf.move\fP
  273. Xmoves a window or icon to a new location, which becomes the
  274. Xdefault location.
  275. X.IP \fBf.moveopaque\fP
  276. Xmoves a window or icon to a new screen location.  When using this
  277. Xfunction, the entire window or icon is moved to the new screen
  278. Xlocation.  The grid effect is not used with this function.
  279. X.IP \fBf.neaten\fP
  280. Xneatens the desktop using the RTL neaten package. See the \fBX DEFAULTS\fP
  281. Xfor the resources necessary to customize this somewhat complex feature.
  282. XThis function only works if \fIawm\fP has been compiled with the -DNEATEN
  283. Xflag (which compiles in the neaten package). Invoking this function without
  284. Xthis is a noop (though a warning diagnostic is printed to stderr).
  285. XSee the INSTALLATION section of the README document for more details.
  286. X.IP \fBf.newiconify\fP
  287. Xallows you to create a window or icon and then position the window or
  288. Xicon in a new default location on the screen.
  289. X.IP \fBf.pause\fP
  290. Xtemporarily stops all display action.  To release the screen and
  291. Ximmediately update all windows, use the \fBf.continue\fP function.
  292. X.IP \fBf.pushdown\fP
  293. Xmoves a window down.  
  294. XThe distance of the push is determined by the push variables.
  295. X.IP \fBf.pushleft\fP
  296. Xmoves a window to the left.  
  297. XThe distance of the push is determined by the push variables.
  298. X.IP \fBf.pushright\fP
  299. Xmoves a window to the right.  
  300. XThe distance of the push is determined by the push variables.
  301. X.IP \fBf.pushup\fP
  302. Xmoves a window up.  
  303. XThe distance of the push is determined by the push variables.
  304. X.IP \fBf.raise\fP
  305. Xraises a window that is being obstructed by a window
  306. Xabove it.
  307. X.IP \fBf.refresh\fP
  308. Xresults in exposure events being sent to the window server clients 
  309. Xfor all exposed or partially exposed windows.
  310. XThe windows will not refresh correctly if the exposure events 
  311. Xare not handled properly.
  312. X.IP \fBf.resize\fP
  313. Xresizes an existing window.  Note that some clients, notably
  314. Xeditors, react unpredictably if you resize the window while the
  315. Xclient is running.
  316. X.IP \fBf.restart\fP
  317. Xcauses the window manager application to restart,
  318. Xretracing the \fIawm\fP search path and initializing the variables it
  319. Xfinds.
  320. X.IP \fBf.\fP[\fBno\fP]\fBdecorate\fP
  321. Xadds or removes "decorations" on the selected window. What decorations are
  322. Xadded (or deleted) depends on the settings of various booleans and
  323. Xclient-specific resources (see: \fBSPECIAL RESOURCES\fP).
  324. X
  325. XThe booleans \fBtitles\fP, \fBgadgets\fP and \fBborderContext.width\fP
  326. Xcurrently influence \fBawm\fP's choice of default decorations.
  327. X.PP
  328. X.SH Modifier Keys
  329. X.PP
  330. XIt is preferable to use meta as a modifier key for \fBawm\fP (or
  331. Xany other window manager, for that matter), but one may also
  332. Xuse ctrl, shift, lock, or null (no modifier key).  
  333. XModifier keys must be entered in lower case, and can be
  334. Xabbreviated as: c, l, m, s  for ctrl, lock, meta, and shift,
  335. Xrespectively. It's also permissible to refer to the the modifier
  336. Xkeys directly as "mod1, mod2, mod3, mod4 or mod5". A mouse button
  337. Xwith no modifier key(s) is often referred to as a "naked" mouse
  338. Xbutton.
  339. X.PP
  340. XYou may bind any number of modifier keys to a function,
  341. Xuse the bar (|) character to combine them.
  342. X.PP
  343. X.SH Context
  344. X.PP
  345. XThe context refers to the screen location of the cursor when a 
  346. Xcommand is initiated.  When you include a context entry in a 
  347. Xbinding, the
  348. Xcursor must be in that context or the function will not be
  349. Xactivated.
  350. XThe window manager recognizes the following seven contexts: 
  351. Xicon, window, root, title, gadget[\fIn\fP] (where \fIn\fP is the
  352. Xgadget number), border and (null).
  353. X.PP
  354. XThe icon context refers to any icon and may be safely bound without
  355. Xinterfering with window events.
  356. X.PP
  357. XThe window context refers to application windows and should be
  358. Xused carefully to avoid usurping button events that applications
  359. Xmay want for their own purposes.
  360. X.PP
  361. XThe root context refers to the root, or background window.
  362. X.PP
  363. XThe title context refers to the titlebar area of a window, if
  364. Xone exists.
  365. X.PP
  366. XThe gadget context (with mandatory index) specifies a given
  367. Xgadget box. Binding to a gadget that's undefined (not initialized to
  368. Xanything) is an error.
  369. X.PP
  370. XThe border context refers to the artificial border area created when
  371. Xthe resource \fBborderContext.width\fP is defined (see \fBborderContext.width\fP
  372. Xunder \fBX DEFAULTS\fP). Using this context when no border area exists
  373. X(i.e. \fBborderContext.width\fP is not defined) is a noop.
  374. X.PP
  375. XA (null) context is indicated when the context field is left blank,
  376. Xand allows a function to be invoked from any screen location. This
  377. Xis basically equivalent to specifying all the possible contexts.
  378. X.PP
  379. XCombine contexts using the bar (|) character.
  380. X.PP
  381. X.SH Mouse Buttons
  382. X.PP
  383. XAny of the following mouse buttons are accepted (in lower case)
  384. Xand may be abbreviated as l, m, or r, respectively:  left, 
  385. Xmiddle, right.
  386. X.PP
  387. XWith the specific button, you must identify 
  388. Xthe action of that button.  Mouse actions 
  389. Xcan be: 
  390. X.IP "\fBdown\fP" 10 
  391. Xfunction occurs when the specified button is pressed down.
  392. X.IP \fBup\fP
  393. Xfunction occurs when the specified button is released.
  394. X.IP "\fBdelta\fP" 10
  395. Xindicates that the mouse must be moved the number of pixels specified 
  396. Xwith the delta variable before the specified function is invoked.
  397. XThe mouse can be moved in any direction 
  398. Xto satisfy the delta requirement.
  399. X.PP
  400. X.SH MENU DEFINITION 
  401. X.PP
  402. XAfter binding a set of function keys and a menu name to
  403. X\fBf.menu\fP, you must define the menu to be invoked, using the
  404. Xfollowing syntax:
  405. X.EX
  406. X\fBmenu \fP= (\fIstring\fP) " \fImenu name\fP " {
  407. X"\fIitem name\fP" : "\fIaction\fP"
  408. X       . 
  409. X       .
  410. X       .
  411. X}
  412. X.EE
  413. X.PP
  414. XThe \fIstring\fP in parenthesis is an optional argument which
  415. Xnames a pixmap file (see also: \fBpath\fP) to use as
  416. Xthe menu title rather than just using the name of the menu. This
  417. Xis generally only useful if you're using pixmaps for the menu
  418. Xpanes as well (see below). Though the \fImenu name\fP isn't displayed
  419. Xwhen you specify \fIstring\fP, you still need to specify one for \fIawm\fP
  420. Xto use when looking up the binding to it.
  421. X.PP
  422. XEnter the \fImenu name\fP exactly the way it is entered with the 
  423. X\fBf.menu\fP function or the window manager will not recognize the link.
  424. XIf the \fImenu name\fP contains blank strings, tabs or parentheses, it must
  425. Xbe quoted here and in the \fBf.menu\fP function entry.  If you haven't
  426. Xchosen to display a pixmap title in \fIstring\fP, the menu name will be
  427. Xdisplayed at the top of the menu in whatever font has been chosen
  428. Xfor \fBmenu.boldFont\fP (or its default).
  429. X.PP
  430. XYou can enter as many menu items as your screen is long.  You  
  431. Xcannot scroll within menus.
  432. X.PP
  433. XAny menu entry that contains quotes, special characters,
  434. Xparentheses, tabs, or strings of blanks must be enclosed 
  435. Xin double quotes.  Follow the item name by a colon (:).
  436. X.PP
  437. XA special case is an item surrounded by parenthesis, which
  438. Xdesignates the \fIitem name\fP as the name of a pixmap file to
  439. Xtile the menu pane with. Given a pixmap for the menu title as well
  440. X(see above), it's possible to create menus that are totally
  441. Xpictorial in nature. There are, however, two caveats. Due to the fact
  442. Xthat it's easier to do, the pixmaps are used as backgrounds
  443. Xfor the menu panes rather than painting them on whenever a given pane in
  444. Xexposed. This has rather ugly consequences if one of the pixmaps
  445. X(or a line of text if a pane is textual) is larger than the others.
  446. XSince the server replicates pixmaps over the entire window, it results
  447. Xin a "wallpaper" effect on the smaller pixmaps. The solution is to make all
  448. Xthe pixmaps the same size and/or not mix in any text items that will need a
  449. Xwider pane. 
  450. X.PP
  451. XThe second problem is that the check marks and pull-right indicators are
  452. Xalways displayed in fixed positions on the right and left edges of menu
  453. Xpanes. If your pixmaps try to use this real-estate, they may be partially
  454. Xcovered by a check mark or pull-right pixmap. Design your menus with this
  455. Xin mind.
  456. X.PP
  457. X.SH Menu Action
  458. X.IP "Window manager functions"
  459. XAny function previously described, e.g., \fBf.move\fP or \fBf.iconify\fP.
  460. XUsing \fBf.menu\fP results in a pull-right pane which you can use to "walk"
  461. Xbetween menus (see below). A "walk" can be done by moving the cursor onto
  462. Xthe pull-right arrow displayed at the right edge of the pane, or by clicking
  463. Xanother button in the pane while holding the original one down.
  464. X.IP "Walking menus"
  465. XSelect the function \fBf.menu\fP and separate it from the \fImenu name\fP with
  466. Xa colon (:) i.e.
  467. X.EX
  468. Xmenu = "foo" {
  469. X...
  470. XWalking Menu:        f.menu:  "NextMenu"
  471. X...
  472. X}
  473. X.EE
  474. X.IP "Text actions"
  475. XThere are two kinds of special "actions" involving arbitrary strings
  476. Xof text. These are:
  477. X.IP "Shell commands"
  478. XBegin with an exclamation point (!) and set to run in
  479. Xbackground.  You cannot include a new line character within a shell
  480. Xcommand. 
  481. X.IP "Text strings"
  482. XText strings are placed in the window server's cut buffer.
  483. X.IP
  484. XStrings with a new line character must begin with an 
  485. Xup arrow (^), which is stripped during the copy operation.  
  486. X.IP
  487. XStrings without a new line must begin with the bar character (|), 
  488. Xwhich is stripped during the copy operation.
  489. X.IP "Booleans"
  490. XAny boolean variable previously described, e.g., \fBreverse\fP or
  491. X\fBautoraise\fP.  The current state of a boolean variable in a menu
  492. Xwill be indicated with a check mark (a check mark means the boolean is
  493. Xset to true).
  494. X.PP
  495. XSPECIAL NOTE:
  496. X.PP
  497. XMenus bound to title bars, gadget boxes or borders cause (where logical)
  498. Xthe selected menu action to occur automatically on the titled window
  499. Xas opposed to having to select a window for the action. However, actions
  500. Xrequiring mouse tracking (i.e. move, resize) will usually \fBnot\fP work well
  501. Xin this context. While this limitation will be eliminated in the near future,
  502. Xit is suggested that you use this feature to do things that do not
  503. Xrequire mouse tracking, such as raise, lower, iconify, etc.
  504. X.PP
  505. X.SH Color Defaults
  506. X.PP
  507. XColors default to the colors of the root window 
  508. Xunder any of the following conditions:
  509. X.IP 1)
  510. XIf you run out of color map entries, either before or during an
  511. Xinvocation of \fIawm\fP.
  512. X.IP 2)
  513. XIf you specify a foreground or background color that does 
  514. Xnot exist in the RGB color database ($LIBDIR/\fIrgb.txt\fP).
  515. X.IP 3)
  516. XIf you omit a foreground or background color.
  517. X.IP 4)
  518. XIf you specify no colors in the resource database.
  519. X.bp
  520. X.SH X DEFAULTS
  521. X.PP
  522. XA number of variables that were previously specified in the \fI.uwmrc\fP file
  523. Xhave been moved out of the \fI.awmrc\fP file and are now retrieved from
  524. Xthe resource database. When a value cannot be found, a default 
  525. X(compiled into \fIawm\fP) is substituted. The resource database is also
  526. Xnow queried to determine whether or not to title a given window. See
  527. Xthe end of this section for details.
  528. X.PP
  529. XIn the descriptions below, variable names are listed in boldface,
  530. Xtheir type in parenthesis, and their default value in double quotes.
  531. X.sp
  532. X.IP "\fBautoraise\fP (boolean) ``off''"
  533. XAutomatically raise a window to the top when it gains the
  534. Xinput focus. See also: \fBraiseDelay\fP
  535. X.IP "\fBautoselect\fP (boolean) ``off''"
  536. XSpecifies that the pointer be placed over the first
  537. Xitem in a menu, rather than the title, when the menu is popped up.
  538. X.IP "\fBbackground\fP (string)"
  539. XThe default background color for all other color
  540. Xchoices in \fIawm\fP. If \fBreverse\fP is not set, this defaults
  541. Xto white, otherwise it defaults to black.
  542. XReferences to \fBbackground\fP in this document
  543. Xrefer to this resource.
  544. X.IP "\fBborder.foreground\fP (boolean) ``\fBforeground\fP''"
  545. XSpecifies the border color to use for all windows (this color
  546. Xmay be drawn solid or stippled, depending on the window focus and
  547. Xthe setting of \fBborder.hilite\fP).
  548. X.IP "\fBborder.hilite\fP (boolean) ``on''"
  549. XSpecifies whether or not window border colors are to
  550. Xbe changed on focus changes. On focus in, the window border is
  551. Xchanged to solid \fBborder.foreground\fP. On focus out, it is changed to a
  552. X"gray" stipple.
  553. X.IP "\fBborderContexts\fP (boolean) ``off''"
  554. XSpecifies whether or not "border context" areas are enabled.
  555. XWill have little effect unless \fBborderContext.width\fP is set
  556. Xto some reasonable value (it defaults to 0).
  557. X.IP "\fBborderContext.background\fP (string) ``\fBbackground\fP''"
  558. XBackground color to use for border context pixmap.
  559. XValue is meaningless if \fBborderContext.width\fP and \fBborderContext.pixmap\fP are undefined.
  560. X.IP "\fBborderContext.boldPixmap\fP (string) ``none''"
  561. XThe name of a pixmap file to load and tile the border context area
  562. Xwith when the focus is in. If this is defined, and \fBhilite\fP is set,
  563. Xfocus changes will cause the border context background to alternate between
  564. X\fBborderContext.pixmap\fP and \fBborderContext.boldPixmap\fP. If \fBborderContext.boldPixmap\fP
  565. Xis defined, but \fBborderContext.pixmap\fP is not, a blank pixmap will be used in place of
  566. X\fBborderContext.pixmap\fP.
  567. X.IP "\fBborderContext.cursor\fP (int) ``XC_cross''"
  568. XGlyph (in decimal) to retrieve from cursor font for use in
  569. Xborder context.
  570. X.IP "\fBborderContext.foreground\fP (string) ``\fBforeground\fP''"
  571. XForeground color to use for border color pixmap.
  572. XValue is meaningless if \fBborderContext.width\fP and \fBborderContext.pixmap\fP are undefined.
  573. X.IP "\fBborderContext.pixmap\fP (string) ``\fBbackground\fP"
  574. XPixmap to display as border context area background.
  575. XValue is meaningless is \fBborderContext.width\fP is undefined (or set to zero).
  576. XUsed exclusively as the background unless \fBborderContext.boldPixmap\fP and
  577. X\fBhilite\fP are defined.
  578. X.IP "\fBborderContext.width\fP (int) ``0''"
  579. XNumber of pixels wide to make the border context. Though
  580. Xfunctions may be bound to the border context (see: \fborderContexts\fP)
  581. Xwithout setting this, they will be impossible to invoke due to the
  582. Xfact that there will be nothing to click on. The border context
  583. Xshould not be confused with the actual window border. It is an
  584. Xartificial area around each window that resembles a border.
  585. X.IP "\fBdelta\fP (int) ``1''"
  586. XNumber of pixels that must be moved over before a "delta" action
  587. Xis taken (see: \fBBINDING SYNTAX\fP).
  588. X.IP "\fBforeground\fP (string)"
  589. XThe default foreground color for all other color
  590. Xchoices in \fIawm\fP. If \fBreverse\fP is not set, this defaults
  591. Xto black, otherwise it defaults to white. 
  592. XReferences to \fBforeground\fP in this document
  593. Xrefer to this resource.
  594. X.IP "\fBframeFocus\fP (boolean) ``off''"
  595. X[De]highlight when the pointer [leaves] enters the "frame" of the
  596. Xwindow (the frame includes the client window, title bar and border context
  597. Xareas, if present). Setting this option also causes the focus to follow
  598. Xthe pointer so that keyboard input will go the the client regardless of
  599. Xwhere the pointer is in the "frame".
  600. X.IP "\fBfreeze\fP (boolean) ``off''"
  601. XLock out all other clients during certain window manager tasks,
  602. Xsuch as move and resize.
  603. X.IP "\fBgadget.border\fP (int) ``1''"
  604. XThe width of all gadget borders in pixels.
  605. X.IP "\fBgadget.font\fP (string) ``fixed''"
  606. XWhich font to use for (textual) gadget labels.
  607. X.IP "\fBgadget.pad\fP (int) ``3''"
  608. XThe number of pixels to pad a gadget from its neighbor if it has
  609. Xno offset defined.
  610. X.IP "\fBgadgets\fP (boolean) ``off''"
  611. XDisplay gadgets in title bars, if any are declared.
  612. X.IP "\fBgrid\fP (boolean) ``off''"
  613. XDisplay a finely ruled grid when positioning or resizing
  614. Xwindows/icons.
  615. X.IP "\fBhilite\fP (boolean) ``off''"
  616. XCauses the following actions to occur when a window gains the input
  617. Xfocus:
  618. X.EX
  619. X1. If \fBshowName\fP is on:
  620. X
  621. X   1a.    If \fBtitle.boldFont\fP is defined, the window name is redrawn
  622. X    in this font.
  623. X
  624. X   1b.    If it's not, then the window name is redrawn in reverse video.
  625. X
  626. X2. If \fBtitle.boldPixmap\fP is defined, the background of the title bar
  627. X   is set to it.
  628. X
  629. X3. If \fBborderContext.boldPixmap\fP is defined, the background of the border
  630. X   context area is set to it.
  631. X.EE
  632. X.IP
  633. XOn focus out, the window name is redrawn in \fBtitle.font\fP
  634. Xthe title background to \fBtitle.pixmap\fP and the border context
  635. Xto \fBborderContext.pixmap\fP, respectively.
  636. X.IP
  637. XIf \fBborder.hilite\fP is undefined, this variable will set it
  638. Xautomatically.
  639. X.PP
  640. X\fBNote that most icon variables only affect icons owned by \fIawm\fP.
  641. XExcept for foreground and background colors, client created
  642. Xicons are left alone.\fR
  643. X.IP "\fBicon.background\fP (string) ``\fBbackground\fP''"
  644. XIcon (pixmap) background color.
  645. X.IP "\fBicon.border\fP (string) ``\fBicon.foreground\fP''"
  646. XColor to use for icon borders.
  647. X.IP "\fBicon.borderWidth\fP (int) ``2''"
  648. XWidth of icon border in pixels.
  649. X.IP "\fBicon.font\fP (string) ``8x13''"
  650. XWhich font to use for icon text.
  651. X.IP "\fBicon.foreground\fP (string) ``\fBforeground\fP''"
  652. XIcon (pixmap) foreground color.
  653. X.IP "\fBicon.hPad\fP (int) ``2''"
  654. XNumber of pixels to pad icon text horizontally.
  655. X.IP "\fBicon.vPad\fP (int) ``2''"
  656. XNumber of pixels to pad icon text vertically.
  657. X.IP "\fBicon.text.background\fP (string) ``\fBicon.background\fP''"
  658. XBackground color to use for icon text.
  659. X.IP "\fBicon.text.foreground\fP (string) ``\fBicon.foreground\fP''"
  660. XForeground color to use for icon text.
  661. X.IP "\fBicon.pixmap\fP (string) ``grey''"
  662. XPixmap to display as icon background.
  663. XSince this pixmap will be used to tile all icons owned
  664. Xby \fIawm\fP, it's probably not a good idea to put application
  665. Xspecific pictures in it. More typically, this will be a cross
  666. Xhatch pattern or some similar background weave.
  667. XSee also: \fBpath\fP, \fBicon.foreground\fP, \fBicon.background\fP.
  668. X.IP "\fBinstallColormap\fP (boolean) ``false''"
  669. XInstall a given window's colormap when the pointer enters it.
  670. XWhen the pointer leaves, the default colormap is installed.
  671. X.IP "\fBmenu.background\fP (string) ``\fBbackground\fP''"
  672. XMenu background color.
  673. X.IP "\fBmenu.boldFont\fP (string) ``8x13bold''"
  674. XWhich font to use for (textual) menu panes. Currently,
  675. Xthe only pane using this font is the title pane (unless, of course,
  676. Xit's a pixmap).
  677. X.IP "\fBmenu.border\fP (string) ``\fBforeground\fP''"
  678. XMenu border color.
  679. X.IP "\fBmenu.borderWidth\fP (int) ``2''"
  680. XWidth of menu border in pixels.
  681. X.IP "\fBmenu.delta\fP (int) ``20''"
  682. XNumber of pixels to move on a "pull-right" pane before the submenu
  683. Xattached to it is popped up.
  684. X.IP "\fBmenu.font\fP (string) ``8x13''"
  685. XWhich font to use in (textual) menu panes.
  686. X.IP "\fBmenu.foreground\fP (string) ``\fBforeground\fP''"
  687. XMenu foreground color.
  688. X.IP "\fBmenu.itemBorder\fP (int) ``1''"
  689. XWidth of individual (menu) item borders.
  690. X.IP "\fBmenu.pad\fP (int) ``2''"
  691. XNumber of pixels to pad menu text/pixmaps vertically.
  692. X.PP
  693. XThe following resources pertain only to the RTL Neaten package and are
  694. Xignored if \fIawm\fP has not been compiled with that option (see the
  695. XINSTALLATION file).
  696. X.IP "\fBneaten.absMinWidth\fP (int) ``64''"
  697. XIndicates the amount of space in pixels, that is used
  698. Xas the absolute minimum width of a window during the
  699. Xneaten operation.
  700. X.IP "\fBneaten.absMinHeight\fP (int) ``64''"
  701. XIndicates the amount of space in pixels, that is used
  702. Xas  the absolute minimum height of a window during the
  703. Xneaten operation.
  704. X.IP "\fBneaten.retainSize\fP (boolean) ``true''"
  705. XForces to windows to be at least their current size.
  706. XWindows may overlap as a side effect.
  707. X.IP "\fBneaten.fill\fP (boolean) ``true''"
  708. XAllows windows to grow to their maximum size during
  709. Xthe neaten  operation. Normally a window will grow only to
  710. Xthe maximum  of its desired (based on the WM_NORMAL_HINTS property)
  711. Xand current size.
  712. X.IP "\fBneaten.fixTopOfStack\fP (boolean) ``true''"
  713. XFixes the size and location of the window at the top of
  714. Xthe  window  hierarchy.  If necessary, this window will
  715. Xoverlap even other windows which can not be tiled.
  716. X.IP "\fBneaten.keepOpen\fP (boolean) ``true''"
  717. XConstrains all windows to remain open during the neaten
  718. Xoperation.   No  windows will be iconized.  This operation
  719. Xmay cause windows to overlap.
  720. X.IP "\fBneaten.usePriorities\fP (boolean) ``true''"
  721. XAssigns the windows priorities based on their stacking
  722. Xorder (windows closer to the top in the stacking order
  723. Xare given higher priorities). Priorities are used when
  724. Xdetermining size and location of windows on the screen.
  725. X.IP "\fBneaten.primaryIconPlacement\fP (string) ``\fBTop\fP''"
  726. XSelects the side of the screen where icons are first
  727. Xplaced.  Legal values are: \fBTop\fP, \fBLeft\fP, \fBBottom\fP, \fBRight\fP and
  728. X\fBClosest\fP (to its current position).
  729. X.IP "\fBneaten.secondaryIconPlacement\fP (string) ``\fBLeft\fP''"
  730. XDetermines where along the specified primary side
  731. Xthe icon should be placed. Legal values are those for
  732. X\fBneaten.primaryIconPlacement\fP plus \fBCenter\fP.
  733. XNot used if \fBneaten.primaryIconPlacement\fP is \fBClosest\fP
  734. X.IP "\fBnormali\fP (boolean) ``on''"
  735. XMake sure that icons created with \fBf.newiconify\fP stay wholly within
  736. Xthe root window (on screen), regardless of attempted placement.
  737. XIf off, put icons
  738. Xwherever the cursor is placed.
  739. X.IP "\fBnormalw\fP (boolean) ``on''"
  740. XMake sure that windows mapped with \fBf.newiconify\fP are placed on-screen,
  741. Xregardless of cursor position.
  742. XIf off, put windows wherever the cursor is placed.
  743. X.IP "\fBpath\fP (string) ``null''"
  744. XA number of items (titles, menus, etc) now allow you to specify
  745. Xa pixmap file, rather than just a text string to display. Since it
  746. Xwould be tedious to type in full pathnames for these files if they
  747. Xall lived in the same places, the directory(s) named by \fBpath\fP are
  748. Xsearched if the pixmap file's pathname does not begin with a slash (/)
  749. Xor tilde (~) and is not found in the current directory.
  750. X.IP
  751. X\fBpath\fP is a white-space separated list of one or more
  752. Xdirectories to search, much like that used by the Unix C-shell. The ~
  753. Xnotation used to designate your (or someone else's) home directory is
  754. Xsupported, but wildcards are not.
  755. X.IP "\fBpopup.background\fP (string) ``\fBbackground\fP''"
  756. XBackground color to use for pop-up text.
  757. X.IP "\fBpopup.borderWidth\fP (int) ``2''"
  758. XWidth of pop-up window border in pixels.
  759. X.IP "\fBpopup.font\fP (string) ``9x15''"
  760. XWhich font to use for popup window text.
  761. X.IP "\fBpopup.foreground\fP (string) ``"\fBforeground\fP''
  762. XForeground color to use for pop-up text.
  763. X.IP "\fBpopup.pad\fP (int) ``4''"
  764. XNumber of pixels to pad pop-up text horizontally.
  765. X.IP "\fBpushRelative\fP (boolean) ``on''"
  766. XWhen a window is pushed, push 1/\fBpush\fP of the window.
  767. XIf off, move window \fBpush\fP pixels.
  768. X.IP "\fBpushDown\fP (boolean) ``false''"
  769. XWhen adding a title bar or border context to a window, put the border or
  770. Xtitle bar area at the current x, y position and "push" the window down to
  771. Xmake room. For windows with an upper edge at or near the top of the screen,
  772. Xthis gives the most asthetically pleasing results. For windows near the
  773. Xbottom, it does not.
  774. XIf set to false, the title bar/border will be added "on top" and the window
  775. Xwill not be moved down. Note that the setting of this resource also affects
  776. Xhow the window is maniplated during resizes, title removals, etc.
  777. X.IP "\fBraiseDelay\fP (int) ``100''"
  778. XAmount of time in milliseconds to wait (while window has focus)
  779. Xbefore raising. If pointer leaves window before time elapses, raise is not
  780. Xperformed.
  781. X.IP "\fBreverse\fP (boolean) ``on''"
  782. XReverse background/foreground colors for titles, menus,
  783. Xgadget windows, popup windows, etc. In the absence of any color
  784. Xspecifications, this results in black-on-white.
  785. X.IP "\fBrootResizeBox\fP (boolean) ``on''"
  786. XPut the resize (popup) window in the upper left corner of the root
  787. Xwindow, rather than on the window being resized. This saves a potentially
  788. Xexpensive refresh that would occur when the popup was unmapped. If your server
  789. Xsupports save-unders,
  790. Xit's generally (but not always) better to turn \fBsaveUnder\fP
  791. Xon instead.
  792. X.IP "\fBsaveUnder\fP (boolean) ``off''"
  793. XUse save-unders for menus and pop-up windows. If the server does not
  794. Xsupport save-unders, this action does nothing.
  795. X.IP "\fBshowName\fP (boolean) ``on''"
  796. XDisplay the window name in a title (assuming that the window is titled
  797. Xin the first place).
  798. X.IP "\fBtitle.background\fP (string) ``\fBbackground\fP''"
  799. XBackground color to use for title pixmap.
  800. X.IP "\fBtitle.boldFont\fP (string) ``none''"
  801. XWhich font to use for titlebar labels if focus is and
  802. X\fBhilite\fP is enabled. If this isn't set, and \fBhilite\fP
  803. Xis, the title text will be displayed with \fBtitle.font\fP in reverse video.
  804. X.IP "\fBtitle.boldPixmap\fP (string) ``none''"
  805. XThe name of a pixmap file to load and tile titlebars with when
  806. Xthe focus is in. If this is defined, and \fBhilite\fP is set, focus changes
  807. Xwill cause title backgrounds to alternate between \fBtitle.pixmap\fP
  808. Xand \fBtitle.boldPixmap\fP. If \fBtitle.boldPixmap\fP is defined, but
  809. X\fBtitle.pixmap\fP is not, a blank pixmap will be used in place of
  810. X\fBtitle.pixmap\fP.
  811. X.IP "\fBtitle.cursor\fP (int) ``XC_left_ptr''"
  812. XGlyph (in decimal) to retrieve from cursor font for use in
  813. Xtitle bar.
  814. X.IP "\fBtitle.font\fP (string) ``vtsingle''"
  815. XWhich font to use for titlebar labels. Used exclusively unless
  816. X\fBtitle.boldFont\fP and \fBhilite\fP are set.
  817. X.IP "\fBtitle.foreground\fP (string) ``\fBforeground\fP''"
  818. XForeground color to use when drawing background (both normal and
  819. Xbold) pixmaps.
  820. X.IP "\fBtitle.pad\fP (int) ``2''"
  821. XNumber of pixels to pad title bar text vertically.
  822. X.IP "\fBtitle.pixmap\fP (string) ``none''"
  823. XThe name of a pixmap file to load and tile titlebars with.
  824. XThis background is use exclusively unless the \fBtitle.boldPixmap\fP is
  825. Xdefined and \fBhilite\fP is set.
  826. X.IP "\fBtitle.text.background\fP (string) ``\fBtitle.background\fP''"
  827. XBackground color to use when drawing title bar text.
  828. X.IP "\fBtitle.text.foreground\fP (string) ``\fBtitle.foreground\fP''"
  829. XForeground color to use when drawing title bar.
  830. X.IP "\fBtitles\fP (boolean) ``off''"
  831. XPut title bars on all windows (both existing windows and new ones as
  832. Xthey're created. See also: \fBf.title\fP
  833. X.IP "\fBvolume\fP (int) ``2''"
  834. XSpecifies the bell volume (delta on volume set with \fIxset\fP).
  835. X.IP "\fBwall\fP (boolean) ``off''"
  836. XRestrict window movement to edges of screen (rootwindow).
  837. XThis feature is fairly handy and should probably be bound to a menu
  838. Xso that it can readily be turned on and off.
  839. X.IP "\fBwarpOnDeIconify\fP (boolean) ``off''"
  840. XWarp pointer to upper right corner of window on de-iconify.
  841. X.IP "\fBwarpOnIconify\fP (boolean) ``off''"
  842. XWarp pointer to center of icon on iconify.
  843. X.IP "\fBwarpOnRaise\fP (boolean) ``off''"
  844. XWarp pointer to upper left corner of window on raise.
  845. X.IP "\fBwindowName.offset\fP (int) ``0''"
  846. XNumber of pixels from the right or left edge of a titlebar
  847. Xto print the window name (assuming that \fBshowName\fP is set).
  848. XIf this value is negative, the name will be offset \fBnameOffset\fP
  849. X(plus the name length) pixels from the right edge. If the value
  850. Xis positive, then the name will be offset \fBnameOffset\fP pixels
  851. Xfrom the left edge. If the value is zero, the name will be centered.
  852. XSince the length of a window name can vary dynamically, this value
  853. Xwill be adjusted, when necessary, to ensure that the name is visible in
  854. Xthe title bar.
  855. X.IP "\fBzap\fP (boolean) ``off''"
  856. XCauses ghost lines to follow the window or icon from its previous
  857. Xlocation to its new location during a move, resize or iconify operation.
  858. X.PP
  859. X.SH SPECIAL RESOURCES
  860. X.IP "\fIname\fP\fB.wm_option.autoRaise\fP (boolean) "
  861. X.IP "\fIname\fP\fB.wm_option.borderContext\fP (boolean) "
  862. X.IP "\fIname\fP\fB.wm_option.gadgets\fP (boolean) "
  863. X.IP "\fIname\fP\fB.wm_option.title\fP (boolean) "
  864. X
  865. XThese resources determine whether or not a given application really wants
  866. Xa title, gadgets, border context area or to be auto-raised.
  867. XThe application's CLASS and NAME (in the WM_CLASS property) are checked
  868. Xagainst the string supplied for \fIname\fP (for example:
  869. XXclock*wm_option.title:  off).
  870. X.IP
  871. XSpecifying one of these resources overrides any other boolean
  872. Xsettings (I.E. \fBawm.titles\fP or \fBawm.gadgets\fP) and
  873. Xmay be used to turn things on and off at the application and/or
  874. Xclass level for applications, regardless of \fBawm\fP's settings.
  875. X
  876. XNote: Both class and name resources are checked, and in that order. Thus
  877. Xspecific applications may override settings for their class, if desired.
  878. X.IP
  879. XThese resources are ``special'' as they are checked for under the
  880. Xapplication's name, not \fIawm\fP's; I.E. \fBxclock.wm_option.autoRaise\fP
  881. Xis not \fBawm.xclock.wm_option.autoRaise\fP as one might think.
  882. X.bp
  883. X.SH EXAMPLES
  884. X.PP
  885. XThe following sample startup file shows the default window
  886. Xmanager options:
  887. X.EX
  888. X# Global variables
  889. X#
  890. Xresetbindings
  891. Xresetmenus
  892. X#
  893. X# Mouse button/key maps
  894. X#
  895. X# FUNCTION    KEYS  CONTEXT  BUTTON    MENU(if any)
  896. X# ========    ====  =======  ======    ============
  897. Xf.menu =      meta  :     :left down   :"WINDOW OPS"
  898. Xf.menu =      meta  :     :middle down :"EXTENDED WINDOW OPS"
  899. Xf.move =      meta  :w|i  :right down
  900. Xf.circleup =  meta  :root :right down
  901. X#
  902. X# Menu specifications
  903. X#
  904. Xmenu = "WINDOW OPS" {
  905. X"(De)Iconify":  f.iconify
  906. XMove:           f.move
  907. XResize:         f.resize
  908. XLower:          f.lower
  909. XRaise:          f.raise
  910. X}
  911. X
  912. Xmenu = "EXTENDED WINDOW OPS" {
  913. XCreate Window:                  !"xterm &"
  914. XIconify at New Position:        f.lowericonify
  915. XFocus Keyboard on Window:       f.focus
  916. XFreeze All Windows:             f.pause
  917. XUnfreeze All Windows:           f.continue
  918. XCirculate Windows Up:           f.circleup
  919. XCirculate Windows Down:         f.circledown
  920. X}
  921. X.EE
  922. X.bp
  923. X.PP
  924. X.SH RESTRICTIONS
  925. X.PP
  926. XThe color specifications have no effect on a monochrome system.
  927. XThere's currently no way to specify a keysym in place of a button
  928. X(up/down/delta) specification. This restriction will be removed in
  929. Xthe near future.
  930. X.PP
  931. X.SH FILES
  932. X.PP
  933. X.nf
  934. X$LIBDIR/rgb.txt 
  935. X$LIBDIR/font 
  936. X/usr/skel/.awmrc
  937. X$LIBDIR/awm/system.awmrc
  938. X$HOME/.awmrc
  939. X.fi
  940. X.PP 
  941. X.SH SEE ALSO
  942. X.PP
  943. XX(1), X(8C)
  944. X.SH AUTHOR
  945. X.PP
  946. X.ce 3
  947. XCopyright 1988
  948. XArdent Computer Corporation
  949. XSunnyvale, Ca
  950. X.PP
  951. XAll Rights Reserved
  952. XPermission to use, copy, modify, and distribute this software and its
  953. Xdocumentation for any purpose and without fee is hereby granted,
  954. Xprovided that the above copyright notice appear in all copies and that
  955. Xboth that copyright notice and this permission notice appear in
  956. Xsupporting documentation, and that the name of Ardent Computer
  957. XCorporation or the author not be used in advertising or publicity
  958. Xpertaining to distribution of the software without specific, written
  959. Xprior permission.
  960. X.PP
  961. X.ce 3
  962. XCOPYRIGHT 1985, 1986
  963. XDIGITAL EQUIPMENT CORPORATION
  964. XMAYNARD, MASSACHUSETTS
  965. XALL RIGHTS RESERVED.
  966. X.LP
  967. XTHE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT NOTICE AND
  968. XSHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL EQUIPMENT CORPORATION.
  969. XDIGITAL MAKES NO REPRESENTATIONS ABOUT THE SUITABILITY OF THIS SOFTWARE FOR
  970. XANY PURPOSE.  IT IS SUPPLIED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY.
  971. X.LP
  972. XIF THE SOFTWARE IS MODIFIED IN A MANNER CREATING DERIVATIVE COPYRIGHT RIGHTS,
  973. XAPPROPRIATE LEGENDS MAY BE PLACED ON THE DERIVATIVE WORK IN ADDITION TO THAT
  974. XSET FORTH ABOVE.
  975. X.LP
  976. XPermission to use, copy, modify, and distribute this software and its
  977. Xdocumentation for any purpose and without fee is hereby granted, provided
  978. Xthat the above copyright notice appear in all copies and that both that
  979. Xcopyright notice and this permission notice appear in supporting documentation,
  980. Xand that the name of Digital Equipment Corporation not be used in advertising
  981. Xor publicity pertaining to distribution of the software without specific, 
  982. Xwritten prior permission.
  983. X.PP
  984. XM. Gancarz,
  985. XDEC Ultrix Engineering Group, Merrimack, New Hampshire, using some algorithms
  986. Xoriginally by Bob Scheifler, MIT Laboratory for Computer Science
  987. X.PP
  988. XJ. Hubbard, U.C. Berkeley, Berkeley, Ca. Ardent Computer, Sunnyvale,
  989. XCa. Various modifications and enhancements using code developed by M.
  990. XGancarz and Digital Equipment Corp.
  991. END_OF_awm/awm.man
  992. if test 40183 -ne `wc -c <awm/awm.man`; then
  993.     echo shar: \"awm/awm.man\" unpacked with wrong size!
  994. fi
  995. # end of overwriting check
  996. fi
  997. echo shar: End of archive 13 \(of 13\).
  998. cp /dev/null ark13isdone
  999. MISSING=""
  1000. for I in 1 2 3 4 5 6 7 8 9 10 11 12 13 ; do
  1001.     if test ! -f ark${I}isdone ; then
  1002.     MISSING="${MISSING} ${I}"
  1003.     fi
  1004. done
  1005. if test "${MISSING}" = "" ; then
  1006.     echo You have unpacked all 13 archives.
  1007.     rm -f ark[1-9]isdone ark[1-9][0-9]isdone
  1008. else
  1009.     echo You still need to unpack the following archives:
  1010.     echo "        " ${MISSING}
  1011. fi
  1012. ##  End of shell archive.
  1013. exit 0
  1014. Mike Wexler(wyse!mikew)    Phone: (408)433-1000 x1330
  1015.